screenRect
Type
function
Summary
Returns the geometry of screens connected to the computer.
Syntax
the [[effective] working] screenRect[s]
Description
Use the screenRect function to find out the available screen sizes and to scale windows to the size of the screen.
In its singular form (screenRect) this function returns the virtual co-ordinates of the primary display.
In its plural form (screenRects) this function returns a list containing the virtual co-ordinates of all the screens currently attached to the system. The first line is always that of the primary display, and the order of the rest are in an OS-specific order.
The virtual co-ordinates of a screen a quadruple of four integers specifying the left, top, right and bottom of the rectangle. The right and bottom edges are not included in the screen's area.
Adding the working adjective to either form returns the virtual co-ordinates of each screen's working-area. The working-area of a screen is defined to be the area not covered by OS furniture (such as the task bar on Windows, and the Dock and Menubar on Mac OS X).
Adding the effective adjective to either form returns the area of the screen the application has to itself. In particular, if the keyboard is activated, it take into account if the keyboard is taking up space on the screen. (Android and iOS only)
The co-ordinates returned by the screenRect family of functions can be anywhere in the virtual desktop defined by the OS - their values will depend on the user's local configuration. In particular, they can take both positive and negative values.
Examples
the screenRect
set the rect of this stack to line 2 of the working screenRects
Related
control structure: function
function: screenType, screenLoc
property: fullscreen
command: export snapshot
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile